ERRATA 机制
概述
jezweb/claude-skills 项目中的版本变更管理机制,用于处理库更新导致的技能内容过时问题,通过分离核心内容和版本变更记录来保持技能内容的稳定性。
关键内容
-
设计原理:当库更新导致技能内容过时时,不立即修改 SKILL.md,而是创建 ERRATA.md 文件记录变更,保持核心内容稳定。
-
文件结构:
- SKILL.md:核心内容(稳定,少改动)
- ERRATA.md:版本变更记录(活跃更新)
-
REFERENCE.md:参考资料
-
状态生命周期:ERRATA 记录有三种状态 - active(当前有效的纠正)、absorbed(已合并到 SKILL.md)、outdated(库再次变更,记录已过时)。
-
优势:提供即时的错误修正能力,同时保持技能内容的稳定性,避免频繁的文档更新造成混乱。
-
应用场景:特别适用于快速发展的前端生态,如 Tailwind CSS、React 等库的频繁更新。
来源
- 04_jezweb_claude_skills_frontend — ERRATA 机制解析
相关
- jezweb/claude-skills — 实现该机制的项目
- Agent Skills — 优化的技能类型